Crie uma nova retirada
POST - https://url.base/api/withdrawal/payphone/new
Endpoint para criar uma nova retirada. Para criar uma nova solicitação de retirada, a solicitação deve ser construída com os seguintes parâmetros.
(*) Informações necessárias.
| campo | Tipo | Descrição |
|---|---|---|
| *amount | Decimal | Valor da transação |
| *document_id | String | Documento de identidade do beneficiário |
| *beneficiaryName | String | Nome completo do beneficiário |
| *beneficiaryLastName | String | Sobrenome do beneficiário |
| *beneficiaryEmail | String | Email do beneficiário |
| *beneficiaryPhone | String | Telefone do beneficiário e conta para onde o dinheiro será transferido, número de exemplo: (5930958602222) |
| *accountType | String | O tipo de conta é (C) para clientes de telefones payphone |
| *data | String | Identificador do pagamento a associar. O campo "order" deve ser único e não repetível. |
| *confirmationURL | Link | URL para confirmação da transação |
| *currency | String | Código ISO da moeda # Países e moedas |
| *country | String | Formato internacional do país # Países e moedas |
| *sign | String | A assinatura dos parâmetros é única para cada transação |
info
Após o usuário concluir o processo de retirada, a ProntoPaga retornará os dados para a URL que você especificou em urlConfirmation
Response OK
{
"uid" = [string] // Identificador da retirada no sistema,
"status" = [string] // Status da retirada,
"data" = [string] // Dados adicionais da transação
}
Status de Retirada Payphone
| Status | Descrição |
|---|---|
| Success | Solicitação Aprovada |
| Canceled | Solicitação Rejeitada - Saiba mais sobre os tipos de retiradas canceladas |
info
Payphone só utiliza os estados 'success' e 'canceled', pois são pagamentos instantâneos
Status response
| Campo | Descrição |
|---|---|
| 200 - 201: OK | Retirada criada com sucesso |
| 401: Unauthorized | Permissão negada |